====== Gnump3d ======

GNUMP3d est un serveur de streaming supportant les formats MP3 et Ogg vorbis. GNUMP3d est distribué sous licence GNU. Il est issu du projet de serveur multimédia Edna.

===== Installation =====

On commence par installer à partir des dépôts : 
  sudo aptitude install gnump3d

A partir de ce momment là, Gnump3d est installé avec les options par défaut. Vous pouvez le voir à l'adresse http://127.0.0.1:8888/. On remarquera alors la rubrique préférence, contenant entre autres le choix des thèmes.

Passons maintenant à la configuration :



===== Configuration =====

Ouvrez le fichier de configuration de gnump3d : 
   gksudo gedit /etc/gnump3d/gnump3d.conf
ou sous KDE
   kdesu kate /etc/gnump3d/gnump3d.conf

=== Répertoire contenant les musiques ===

Recherchez "root = /var/music" et remplacez-le par le répertoire de votre choix, par exemple "root = /home/toto/musique"

puis cherchez "user = gnump3d" et remplacez-le par "user = root"

=== Changer le port par défaut ===

Par défaut le port par lequel on accède à gnump3d est le port 8888, mais vous pouvez vouloir le changer, pour ce faire, cherchez "port = 8888" et remplacez-le par le port de votre choix, par exemple "port = 8889".

Si vous voulez pouvoir accéder à votre serveur musical depuis un autre ordinateur et que vous êtes derrière un routeur, assurez-vous que le port que vous choisissez est bien redirigé.

=== Sécurité : par mot de passe ===

Il est possible de demander à Gnump3d d'exiger un mot de passe pour accéder aux musiques, pour cela, il suffit de créer dans votre dossier musique (/home/toto/musique si l'in reprend le même exemple) un fichier nommé ".password" et de définir un ou plusieurs utilisateurs comme suit : 
   utilisateur:mot_de_passe
   deuxieme_utlisateur:mot_de_passe_correspondant
   visiteur:toto

Il est également possible d'utiliser des mots de passe crypté (hash md5), pour cela, il faut d'abord le signaler à gnump3d. Cherchez "authentication_type". La ligne est commentée, enlevez le "#" et écrivez :
   enable_password_protection = 0
   authentication_type = Digest

Ainsi Gnump3d est au courant que les mot-de-passe sont cryptés, mais il faut justement les crypter, pour cela il existe la commande : 
   echo -n 'utilisateur:GNUMP3d:mot_de_passe' | md5sum
Prenons par exemple : nom d'utilisateur = visisteur et mot de passe = toto
   echo -n 'visiteur:GNUMP3d:toto' | md5sum
   8804728ffbe7b4641e4377ddc3a59292  -

On mettra donc la ligne suivante dans .password : 
   visiteur:8804728ffbe7b4641e4377ddc3a59292

=== Sécurité : par IP ===

Il est tout à fait possible de n'autoriser que certains types d'IP. Pour cela, recherchez "allowed_clients = all" et remplacez-le selon vos besoin par : 
Une seule personne (adresse ip a choisir) : 
   allowed_clients = 192.168.2.12
ou tout le monde (option par défaut) : 
   allowed_clients = all
ou personne :
   allowed_clients = none

=== Nom de Domaine ===

Si vous comptez partager vos musiques, ou avoir la possibilité de les écouter par internet, vous pouvez avoir besoin de les mettre sur un site et donc sur un nom de domaine. Pour cela, recherchez "hostname". La ligne est commentée, décommentez la et inscrivez "hostname = monsite.org". Votre serveur sera alors accessible depuis monsite.org:8888 (ou le port que vous avez configuré)

=== Enregistrer les changements ===

Pour finir, enregistrez les changements et relancez gnump3d par la commande : 
   sudo /etc/init.d/gnump3d restart 